home *** CD-ROM | disk | FTP | other *** search
/ BMUG PD-ROM BV3 / BMUG PD-ROM Version BV3 (CDRM1097900).iso / Telecom / Compacting Programs / Stuffit Stuff / btoa⁄atob Translator / About btoa⁄atob Translator next >
Text File  |  1991-01-01  |  11KB  |  290 lines
  1. btoa/atob Translator for StuffIt Deluxe
  2.  
  3. Version 1.0 of 90.12.31.
  4.  
  5. Written by Raymond Lau
  6.  
  7. Copyright (C) 1990, Raymond Lau.  All Rights Reserved.
  8.  
  9.  
  10. This software is being licensed to you free of cost.
  11.  
  12. Please see Terms of usage and distribution at the end
  13. of this document for information regarding your right
  14. to use and distribute this software.
  15.  
  16.  
  17.  
  18. Introduction:
  19.  
  20. btoa/atob Translator is an external translator for use
  21. with StuffIt Deluxe, available from Aladdin Systems, Inc.,
  22. Deer Part Center, #23A-171, Aptos, CA 95003-4723.
  23. This translator provided compatibility with the UNIX filters
  24. "btoa" and "atob."
  25.  
  26. btoa and atob are UNIX filters which convert 8 bit binary
  27. data to 7 bit ASCII data for transmission across channels
  28. which only support 7 bit ASCII data.  For example, you can
  29. only email 7 bit ASCII data with SMTP.  btoa/atob performs
  30. the same function as uuencode/uudecode in the UNIX world but
  31. more efficiently, encoding 4 bytes into 5 instead of 3 into 4.
  32. BinHex4 on the Mac performs a similar function.
  33.  
  34. Why use btoa/atob instead of other similar utilities?
  35.      1. btoa/atob is the most effective ASCII encoder
  36.         compatible with UNIX SMTP mailers that I know of.
  37.      2. btoa/atob is compatible with the encoding used
  38.         by the popular "tarmail" script.
  39. Why use something OTHER than btoa/atob?
  40.      1. With the MacBinary option built into this translator,
  41.         you can transfer entire Macintosh files, including
  42.         applications, as 7 bit ASCII data.  However, the
  43.         protocol provided here is not as of this writing
  44.         an accepted standard whereas BinHex4 is for this
  45.         purpose.  Also, BinHex4 provides better error
  46.         detection.  However, the error detection in
  47.         btoa/atob is reasonably sound.
  48.  
  49.  
  50. Installation:
  51.  
  52. The rest of this documentation assumes that you have properly
  53. installed StuffIt Deluxe and are familiar with the operation
  54. of StuffIt Deluxe.
  55.  
  56. To install this translator, placed it in the Translators
  57. folder in the System folder of your startup drive.  Then
  58. launch (or quit and relaunch, as appropriate) StuffIt Deluxe.
  59.  
  60. If you are in Standard menu mode, you must switch to Expert
  61. menu mode to use this translator.
  62.  
  63.  
  64. Operation:
  65.  
  66. After installation, you should have a new choice under the
  67. Other menu with the name "btoa/atob."  This item has
  68. 2 subitems.  The subitems are Binary to ASCII... and ASCII
  69. to Binary...
  70.  
  71. To convert a binary file to ASCII, select Binary to ASCII.
  72. At the bottom of the dialog should be a checkbox labelled
  73. "Make MacBinary."  If you are encoding a "Macintosh" file,
  74. you should have this checked.  Doing so will cause the
  75. translator to first convert your file to MacBinary format
  76. before doing btoa translation.  If you only wish to encode
  77. the data fork of a file, without saving information about
  78. the file such as its type/creator, then uncheck this.
  79.  
  80.    Example:  You want to email an application to your friend.
  81.              Check Make MacBinary.
  82.              You have a binary PostScript file and want to
  83.              email it to a distant location for printing
  84.              from a UNIX printer server.  Uncheck Make
  85.              MacBinary.
  86.  
  87.    Note:     The MacBinary encoding is compatible with the
  88.              mbget/mbput filters.
  89.  
  90. To convert an encoded ASCII file to a binary file, select
  91. ASCII to Binary.  Normally, you should keep Recognize
  92. MacBinary checked.  The translator will know when a file
  93. being decoded has been MacBinary encoded and when it hasn't.
  94. However, if you know the file was not from a Macintosh
  95. source (or that it wasn't MacBinary encoded), then keep this
  96. unchecked.  The MacBinary header does not have rigorous
  97. presence indicators built into it so non-MB encoded files may
  98. be mistaken for MB encoded files.
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105. Appendix A: Excerpts from man page for the btoa/atob filters.
  106.  
  107. NAME: btoa, atob, tarmail, untarmail encode/decode binary to
  108.       printable ASCII
  109.  
  110. SYNOPSIS: btoa < inbinary > outtext
  111.           atob < intext > outbinary
  112.           tarmail who subject files ...
  113.  
  114. DESCRIPTION: btoa is a filter that reads anything from the
  115.              standard input, and encodes it into printable ASCII
  116.              on the standard output.  It also attaches checksum
  117.              information used by the reverse filter "atob" to
  118.              check integrity.  atob gives NO output (and exits
  119.              with an error message) if its input is garbage or the
  120.              checksums do not check.
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128. Appendix B: Terms of usage and distribution:
  129.  
  130. Although copyrighted, this software is being licensed 
  131. to you for your use free of charge.  However, ownership
  132. of and interest in this software shall remain with the
  133. author.  Use and distribution of this software is
  134. governed by the following terms in an effort to
  135. reasonably insure that this software will remain
  136. freely available and that no one other than the author
  137. will derive a commercial benefit from distributing
  138. this software.
  139.  
  140.  
  141. LICENSE AGREEMENT
  142.  
  143.  
  144. "You," "your," and the "user" refers to any person or
  145. entity which acquires or uses this software.
  146.  
  147. "Software" refers to any computer programs identified
  148. at the start of this documentation file, together with
  149. all codes, techniques, software tools, formats, designs,
  150. concepts, methods, ideas, and documentation assoicated
  151. with the computer program(s).  The term also includes
  152. all copies of any part of the software and documentation.
  153.  
  154. "Author" refers to the author of this software, Raymond
  155. Lau.
  156.  
  157.  
  158. This software is owned by the author and contains
  159. valuable and proprietary information of the author's.
  160. If you violate any part of this agreement, your right
  161. to use this software terminates automatically.  In the
  162. event of termination of this agreement, you must destroy
  163. all copies of this software and derivatives of this
  164. software in your possession and cease distributing the
  165. same.
  166.  
  167. This software is being licensed to you as provided by
  168. the terms of this agreement.
  169.  
  170. You may:
  171.    1. Use this software on as many computers
  172.       as you want at any given time.
  173.    2. Make as many backup copies of this software as
  174.       you want.
  175.    3. Alter the software in any manner you see fit
  176.       FOR YOUR OWN PERSONAL USE.  Such altered versions
  177.       should not be distributed.  The creation of
  178.       such derivatives shall not diminish the author's
  179.       title to this software.
  180.    4. Terminate this agreement at any time by destroying
  181.       all copies of this software and derivatives of
  182.       this software and cease distributing the same.
  183.  
  184. You may not:
  185.    1. Create any derivative works from this software
  186.       for distribution.
  187.    2. Reverse engineer, disassemble, decompile, or
  188.       otherwise attempt to discover the source code to
  189.       this software.
  190.    3. Use this software in any manner as to discover
  191.       proprietary information relating to the Translator
  192.       interface in StuffIt Deluxe.
  193.  
  194.  
  195. You may distribute this software provided that:
  196.    1. This software is distributed free of any charges
  197.       except as provided for under 1a.  This software may
  198.       not be sub-licensed, sold, lent, rented, or leased
  199.       except as provided for under 1a.
  200.           1a. You may charge a nominal fee to cover
  201.               duplication, shipping and/or handling costs
  202.               of distributing this software provided that
  203.               the pro-rata fee (ex: the fee of ordering a
  204.               disk/CD/tape/etc divided by the number of 
  205.               programs on it) does not exceed US $1.  You
  206.               may include this software in any compilation
  207.               even if you sell the compilation for a
  208.               profit provided that the pro-rata fee defined
  209.               above does not exceed US $1 for this software.
  210.  
  211.               You may also charge your usual timesharing,
  212.               network usage and/or membership fee if you
  213.               distribute this software electronically.
  214.  
  215.               While you may claim a compilation copyright
  216.               on any compilations which include this
  217.               software, interest in and ownership of this
  218.               software shall remain with the author.
  219.             
  220.    2. You include this documentation file with the
  221.       distribution.
  222.    3. You do not modify either this documentation file
  223.       or the software itself.
  224.    4. You do not use the name of this software or
  225.       of the author or the fact that you provide this
  226.       software in any promotional material relating
  227.       to your distribution of this software.  However, you
  228.       may include such information in a catalog listing of
  229.       your offerings.
  230.    5. You may not transfer this software in a manner as
  231.       to violate any regulations relating to the transfer
  232.       of software, including the US Export Administration
  233.       Act.
  234.  
  235. Disclaimer of warranty:
  236.  
  237. In using this software, you understand and agree that this
  238. software is provided "as is" without warranty of any kind.
  239. The entire risk as to the results and performance of using
  240. this software lies entirely with you, the user.  The author
  241. does not make any warranties, either expressed or implied,
  242. including but not limited to implied warranties of
  243. merchantability and fitness for a particular purpose, with
  244. respect to this software.
  245.  
  246. In no event shall the author be liable for any consequential,
  247. incidental, or special damages whatsoever (including without
  248. limitation damages for loss of critical data, loss of profits,
  249. interruption of business, and the like) arising out of the
  250. use or inability to use this software.
  251.  
  252. Although the author would appreciate any feedback and bug
  253. reports, the author shall not be responsible for correcting
  254. any problems which you discover or otherwise help you
  255. maintain and use this software.  Furthermore, the author
  256. may at any time replace, modify, alter, improve, enhance
  257. or change this software.
  258.  
  259.  
  260. Complete agreement:
  261.  
  262. This agreement constitues the entire agreement and supersedes
  263. any prior agreements between you and the author concerning
  264. this software.  This agreement cannot be amended, modified,
  265. or waived except in writing.
  266.  
  267. General:
  268.  
  269. If any provision of this agreement shall be found to be
  270. unenforcible, it shall be deemed severed from the remainder
  271. of this agreement.
  272.  
  273. This agreement shall be construed in accordance with the laws
  274. of the State of New York.  Any arbitration or litigation
  275. relating to this agreement shall take place in the State of
  276. New York.
  277.  
  278.  
  279.  
  280. U.S. GOVERNMENT RESTRICTED RIGHTS
  281.  
  282. This Software is provided with RESTRICTED RIGHTS.  Use,
  283. duplication, or disclosure by the government is subject to
  284. restrictions set forth in subparagraph (c)(1)(ii) of the
  285. Rights in Technical Data and Computer Software clause at
  286. 48 CFR 252.227-7013, or in subparagraphs (a) through (d) of
  287. the Commercial Computer Software Restricted Rights clause at
  288. 48 CFR 52.227-19, as applicable.  The contractor/manufacturer
  289. is Raymond Lau, 100-04 70 Ave., Forest Hills, NY 11375-5133.
  290.